Inside Macintosh: QuickDraw GX Objects /

Chapter 4 - Colors and Color-Related Objects / Colors and Color-Related Objects Reference

Color Profile Functions / Creating and Manipulating Color Profile Objects

GXDisposeColorProfile

You can use the GXDisposeColorProfile function to release a reference to a color profile object.

void GXDisposeColorProfile(gxColorProfile target);

target

A reference to the color profile to dispose of.

DESCRIPTION

The GXDisposeColorProfile function decrements the owner count of the color profile object referenced in the target parameter and releases any memory used by the color profile if the owner count goes to 0.

SPECIAL CONSIDERATIONS

If you attempt to dispose of a color profile object used by an onscreen view device, this function posts a colorProfile_access_restricted warning.

ERRORS, WARNINGS, AND NOTICES

Errors
colorProfile_is_nil
Warnings
colorProfile_access_restricted	(debugging version)

SEE ALSO

Owner counts are discussed in the section "Copying, Comparing, and Cloning Color Sets and Color Profiles" beginning on page 4-44, and in the section "Manipulating Owner Counts" beginning on page 4-46. To examine the owner count of a color profile, use the GXGetColorProfileOwners function, described on page 4-84.